QuickTime 3 Reference

| Previous | Chapter Contents | Chapter Top | Next |

SMPTE Matrix Effects

kMatrixTransitionType ('smp4')

This effect is an implementation of the 34 matrix effects from ANSI/SMPTE 258M-1993, plus two Apple-defined wipes that choose a random effect. These are a series of matrix "reveal" type effects that take place between two sources. For full definitions of these 34 matrix effects and what they look like, please refer to the SMPTE documentation.

Example:

The SMPTE effects take two sources and seven parameters.

Parameters

Use the descriptions below to help you understand what the parameters do. To learn how to use parameter atoms, see "Adding Video Effects to a QuickTime Movie"

Name

Code

QTAtom Type

Description

Percentage

'pcnt'

kParameterTypeDataFixed

Always a tween

This parameter contains a tween. As the effect progresses, QuickTime renders the frame of the effect indicated by the tween's current value, as a percentage of the whole effect. For example, if the tween goes from 0 to 100, the effect renders completely; if the tween goes from 25 to 75, rendering begins 25% into the effect and terminates 75% through the effect.

Wipe ID

'wpID'

kParameterTypeDataEnum

Contains the SMPTE ID for the effect. By setting this parameter, you control which of the 34 available matrix effects is used.

Soft border

'soft'

kParameterTypeDataBitField

If this parameter contains true , the border drawn around the second source is blurred.

Border width

'widt'

kParameterTypeDataFixed

Can be a tween

The width, in pixels, of a border that is drawn around the second source.

Border color

'bclr'

kParameterTypeDataRGBValue

Can be a tween

The RGB color of the border around the second source.

Horizontal repeat

'hori'

kParameterTypeDataLong

Can be a tween

The number of horizontal repeats of the effect that are executed in a single source.

Vertical repeat

'vert'

kParameterTypeDataLong

Can be a tween

The number of vertical repeats of the effect that are executed in a single source.

Wipe ID Enum

The Wipe ID parameter can take the following values:

301. Horizontal matrix
302. Vertical matrix
303. Top left diagonal matrix
304. Top right diagonal matrix
305. Bottom right diagonal matrix
306. Bottom left diagonal matrix
310. Clockwise top left matrix
311. Clockwise top right matrix
312. Clockwise bottom right matrix
313. Clockwise bottom left matrix
314. Counter clockwise top left matrix
315. Counter clockwise top right matrix
316. Counter clockwise bottom right matrix
317. Counter clockwise bottom left matrix
320. Vertical start top matrix
321. Vertical start bottom matrix
322. Vertical start top opposite matrix
323. Vertical start bottom opposite matrix
324. Horizontal start left matrix
325. Horizontal start right matrix
326. Horizontal start left opposite matrix
327. Horizontal start right opposite matrix
328. Double diagonal top right matrix
329. Double diagonal bottom right matrix
340. Double spiral Top matrix
341. Double spiral bottom matrix
342. Double spiral left matrix
343. Double spiral right matrix
344. Quad spiral vertical matrix
345. Quad spiral horizontal matrix
350. Vertical waterfall left matrix
351. Vertical waterfall right matrix
352. Horizontal waterfall left matrix
353. Horizontal waterfall right matrix
409. Random effect - one of the 133 SMPTE effects is chosen at random.
504. Random matrix - one of the 34 SMPTE matrix effects is chosen at random.


© 1998 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |